home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / mdf145.zip / MDF_ENG.DOC < prev    next >
Encoding:
Text File  |  1995-08-21  |  12.3 KB  |  412 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Release  1.45
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.       Simple but complete program to produce and apply patches to your programs
  27.               and data files for Dos, OS/2, Windows 95 and Windows NT.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                                   English version.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                   (C) 1995/96 Maurizio Giunti - All rights reserved
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.      1.INDEX
  59.  
  60.  
  61.      1.INDEX                                                                  2
  62.  
  63.  
  64.      2.DISCLAIMER                                                             3
  65.  
  66.  
  67.      3.WARRANTY                                                               3
  68.  
  69.  
  70.      4.WHY?                                                                   3
  71.  
  72.  
  73.      5.WHAT MDIFF-MPATCH DO?                                                  3
  74.  
  75.  
  76.      6.DOS, OS/2, WINDOWS 95 AND WINDOWS NT                                   3
  77.  
  78.  
  79.      7.LIMITS                                                                 3
  80.  
  81.  
  82.      8.MDIFF - MDIFF2 - MDIFFW                                                4
  83.  
  84.  
  85.      9.MPATCH - MPATCH2 - MPATCHW                                             4
  86.  
  87.  
  88.      10.MDF2EXE - MDF2EXE2 - MDF2EXEW                                         5
  89.  
  90.  
  91.      11.ADVICES                                                               5
  92.  
  93.  
  94.      12.LIBRARIES TO APPLY PATCHES                                            5
  95.  
  96.  
  97.      13.HOW TO REGISTER                                                       6
  98.  
  99.  
  100.      14.ACKNOWLEDGEMENTS                                                      6
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                                                               2
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.      2.DISCLAIMER
  120.      This software belongs to Shareware programs: anyone can freely distribute
  121.      and use it for a trial period of 15 days.  After this  period, users that
  122.      continue to use it must register  their copy by sending the  registration
  123.      fee to the  author, Maurizio Giunti.
  124.      The registered users will receive a "registration key".
  125.      Tis sofware can  be freely distributed  at no cost,  except for  eventual
  126.      copy and/or shipping expensee. It is imperative anyway that  the ORIGINAL
  127.      PACKET is distributed without any modification WHATSOEVER.
  128.      There is an  exception: you  can distribute  MPATCH.EXE (or  MPATCH2.EXE)
  129.      with one or more *.MDF files produced with a REGISTERED copy of MDIFF.
  130.  
  131.  
  132.  
  133.        WARRANTY
  134.      3.
  135.      The only warranty that  comes with this software  is that it will  occupy
  136.      disk space. I absolutely can NOT warrant that it will perfectly  work, or
  137.      that it will be your problems' solution.
  138.      Nevertheless, it is not a virus and does not contain (unless  infected or
  139.      modified after  the   compilation) Trojan-horses,  backdoors and  similar
  140.      tricky garbage.  In any  case, the  author is  not responsible   for  any
  141.      damage, moral or material, direct or indirect, derived from its use.
  142.  
  143.  
  144.  
  145.        WHY?
  146.      4.
  147.      A few month ago I was updating a program of mine: the  commpressed packet
  148.      was about 200 Kbytes I thought it was better to use a patch,  but I could
  149.      not find a program of my satisfaction among the patch makers/appliers. In
  150.      addition I could not trace a program that could run under DOS and OS/2.
  151.      I decided to make my own patch software and.....here it is ! 8-)
  152.  
  153.  
  154.  
  155.        WHAT MDIFF-MPATCH DO?
  156.      5.
  157.      MDIFF creates a binary difference between two files. With MPATCH  and the
  158.      older file you can create a  new file using the difference file.  What is
  159.      the advantage? Usually the difference file is smaller and  therefore more
  160.      suitable for distribution, especially by modem.
  161.  
  162.  
  163.  
  164.      6.DOS, OS/2, WINDOWS 95 AND WINDOWS NT
  165.      I obtain MDIFF and  MPATCH for Dos, OS/2  and Windows32 by compiling  the
  166.      same source, so there is NO difference between them.  Moreover difference
  167.      files produced with MDIFF for Dos  can be used with   MPATCH for OS/2  or
  168.      Windows32 and vice-versa.
  169.  
  170.  
  171.  
  172.      7.LIMITS
  173.      MDIFF can't work  on files  greater than 16  Mbytes. There  are no  other
  174.      limits to MDIFF's work.
  175.  
  176.                                                                               3
  177.  
  178.  
  179.  
  180.  
  181.  
  182.      Since its source  is the same  of Dos' MDIFF,  OS/2's MDIFF can't  manage
  183.      Extended Attributes: it will ignore them.
  184.  
  185.  
  186.  
  187.      8.MDIFF - MDIFF2 - MDIFFW
  188.      MDIFF compares  2 files  and stores  the differences  between  them in  a
  189.      difference file. This is the command line  syntax:
  190.  
  191.         MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] [-P<pwd>] <OldFile> <NewFile>
  192.                                      [<MDFfile>]
  193.  
  194.      <OldFile> is the name of the older file, <NewFile> is the name of the new
  195.      file. If you wish you can specify  the  name of the difference  file that
  196.      MDIFF will produce, otherwise MDIFF will  create a file with the name  of
  197.      the  new file but with the extension ".MDF".
  198.      To search differences between files, MDIFF  use a base string of  defined
  199.      length named Chunk. The Chunk length is  by default 16 bytes, but you can
  200.      change it, in the range 4-256, with the -C switch followed by the desired
  201.      length.
  202.      When MDIFF loses the synchronism between the two files being compared, it
  203.      scans the  older file  searching the   current  chunk.  This scansion  is
  204.      executed, by default, in a range of  8 blocks of 512 bytes each.  You can
  205.      change the number of the blocks  scanned, in the range 1-16, with  the -R
  206.      switch followed by the desired number of  blocks.
  207.      If this  search fails,  MDIFF tries  to force  synchronization through  a
  208.      large range search. This range is defined as 1/16 of the old file lenght,
  209.      but you can change it by the -F switch on the command line.
  210.      If you specify -S switch, MDIFF  will provide some information about  the
  211.      composition of the difference file.
  212.      Moreover you can add to the difference file produced a short comment (max
  213.      2 Kbytes) to display when the patch is applied, with the -Z switch. MDIFF
  214.      gets the comment  from standard  input, so you  can type  it directly  or
  215.      redirect it from a file with the "<" command.
  216.      You can also protect the patch by a password using the -P switch followed
  217.      by the password.
  218.  
  219.  
  220.  
  221.      9.MPATCH - MPATCH2 - MPATCHW
  222.      With the old  file and  the .MDF file  you can  rebuild the  new file  by
  223.      running MPATCH. This is the command line  syntax:
  224.  
  225.                  MPATCH [-P<pwd>] <MDFfile> [<OldFile> [<NewFile>]]
  226.  
  227.      MPATCH needs  only  the name  of  the  mdf file  (<MDFfile>)  because  it
  228.      contains the names of the other  2 files, but  it's possible  to override
  229.      these names specifying the desired names on the command line.  MPATCH has
  230.      only the -P switche by which you can specify a password.
  231.      If there  are  errors  during  the  patch  applying,  MPATCH  returns  an
  232.      errorlevel as follows:
  233.          0    "OK!"
  234.          1    "Out of memory !"
  235.          2    "Can't open MDF file !"
  236.          3    "Invalid MDF file !"
  237.                                                                               4
  238.  
  239.  
  240.  
  241.  
  242.  
  243.          4    "MDF file version mismatch !"
  244.          5    "UNREGISTERED !"
  245.          6    "Bad or incorrect OLD file !"
  246.          7    "Can't open OLD file !"
  247.          8    "Can't create NEW file !"
  248.          9    "General failure: NEW file corrupted !"
  249.         10    "OLD and NEW can't be the same file !"
  250.         11    "NEW file was already patched !"
  251.         12    "Bad password !"
  252.  
  253.  
  254.  
  255.         MDF2EXE - MDF2EXE2 - MDF2EXEW
  256.      10.
  257.      MDF2EXE is a simple utility which transforms one or more (up to  127) MDF
  258.      patch files created by MDIFF, to an executable (Dos, OS/2  or Windows32),
  259.      self installing, file.
  260.      MDF2EXE syntax is:
  261.  
  262.            MDF2EXE <mdf_file 1> [<mdf_file 2>....<mdf file n>] <exe_file>
  263.  
  264.      Where <mdf_file x> can contain wildcards.
  265.      The <exe_file> (which MUST have .EXE extension) will be  executed without
  266.      any parameters on the command line. It will automatically search the file
  267.      to update.
  268.      Eventually you can use a -P switch to specify a password or the  -V or -L
  269.      switches to list the patches contained in the file.
  270.      Warning: don't compress a self installing patch by PKLite or LZexe.
  271.  
  272.  
  273.  
  274.         ADVICES
  275.      11.
  276.      The best method to build  a difference file, is  to search the chunks  of
  277.      the new file in the entire  older file, but this  is  a very slow way  to
  278.      do!
  279.      MDIFF's algorithm tries to give a  small diff file in the faster  way; so
  280.      you are sometimes required to tune the work  parameters with  the command
  281.      line switches.
  282.      Let's look at some typical situations:
  283.        Very similar files: use a  large chunk (32, 64  or more) to reduce  the
  284.      1. 
  285.        size of  the diff  file, in  particular if  the files  contain text  or
  286.        archives.
  287.      2. 
  288.        Text files: try to use a  chunk size of 32,  sometimes it is better  to
  289.        turn the forced sync off or reduce its range by the -F switch.
  290.      3. 
  291.        Very large executable: try to use  a larger resync range (16 or  more),
  292.        with the -R switch.
  293.      Remember: MDIFF  can't  make  miracles!  If  the  two  files  are  really
  294.      different, the patch will result very  large. In this situation you  must
  295.      distribute the entire new file. MDIFF  is useful only when the number  of
  296.      changes is limited.
  297.  
  298.  
  299.  
  300.         LIBRARIES TO APPLY PATCHES
  301.      12.
  302.      Up to release 1.40 I included in MDIFF distribution packet a set  of Dos,
  303.      Windows and OS/2 libraries to produce patcher programs.
  304.                                                                               5
  305.  
  306.  
  307.  
  308.  
  309.  
  310.      Since I had no feedback and my  spare time had reduced, I decided  I will
  311.      not distribute them anymore.
  312.      I will try  to develope the  libraries but  I think I  will not  develope
  313.      their docs, so if you REALLY need them, please contact me.
  314.  
  315.  
  316.  
  317.         HOW TO REGISTER
  318.      13.
  319.      The individual registration key costs Italian Liras 25,000  (approx U.S.$
  320.      16.-). The  key is  valid for  DOS, OS/2  and Windows32  versions of  the
  321.      software up to release 1.99. The  registration key will be sent by  mail.
  322.      If explicity requested, it can also be sent via Internet e-mail.
  323.      The registration fee can be paid  according to your preference, by  check
  324.      or postal  order (in  Italy) or  International  Money Order  (I.M.O.)  or
  325.      Postalgiro, from abroad, payable to:
  326.  
  327.                                    Maurizio Giunti
  328.                                 Via G.B. Foggini, 24
  329.                                  50142 Firenze (FI)
  330.                                         ITALY
  331.  
  332.  
  333.      If you are in Europe you can also send me an Eurocheque in Italian Lire.
  334.      It is better to indicate on  the order the name  of the program you  want
  335.      to register, your name, address and FAX  number or e-mail  address (where
  336.      available). For  short notes,  use the  appropriate space  on the  postal
  337.      order (if present), or send an e-mail to Maurizio Giunti at:
  338.  
  339.                                 Fidonet: 2:332/102.3
  340.  
  341.                              Internet: giunti@abeline.it
  342.  
  343.  
  344.  
  345.         ACKNOWLEDGEMENTS
  346.      14.
  347.      I'd like to thank all  those who helped me  to develop this software  and
  348.      its documentation  and all  those  who   helped  me in  beta-testing.  In
  349.      alphabetical order:
  350.  
  351.                                    Andrea Baitelli
  352.  
  353.                                     Silvia Borri
  354.  
  355.                                     Filippo Dini
  356.  
  357.                                  Fabrizio Fioravanti
  358.  
  359.                                  Cristiano Guidoccio
  360.  
  361.                                 Giovanni Lopes Pegna
  362.  
  363.                                   Marco Maccaferri
  364.  
  365.                                   Marco Menichelli
  366.  
  367.                                                                               6
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                                    Giuseppe Scarpi
  374.  
  375.                                    Toni Tatafiore
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                                                                               7
  429.  
  430.